home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / util / batch / RequestString.readme < prev   
Text File  |  1997-01-05  |  4KB  |  108 lines
  1. Short:    Asks for text, many options, pure, v39.0
  2. Author:   kessler@fen.baynet.de (Thomas Kessler)
  3. Uploader: kessler@fen.baynet.de (Thomas Kessler)
  4. Version:  39.0
  5. Type:     util/batch
  6. Requires: AmigaOS 2.0+, util/libs/ReqToolUsr.lha V38+
  7.  
  8. RequestString                                                   RequestString
  9.  
  10.    NAME
  11.     RequestString
  12.  
  13.    VERSION
  14.     RequestString 39.0 by Thomas Kessler (12.08.94)
  15.  
  16.    DISCLAIMER
  17.     RequestString ©1994-96 Thomas Kessler (kessler@fen.baynet.de)
  18.     All rights reserved.
  19.  
  20.     RequestString uses 'reqtools.library' V38+
  21.     ©1991-1994 Nico François, ©1995-1996 Magnus Holmgren
  22.     available on aminet: util/libs/ReqToolUsr.lha
  23.  
  24.     This software is EMAILWARE (Freeware).
  25.     Please send me a small email if you like and use this program.
  26.  
  27.     This software is provided as-is, without warranty of any kind,
  28.     either expressed or implied. In no event will the author be liable
  29.     for direct, indirect, incidental or consequential damages or data
  30.     loss resulting from the use or application of this software. The
  31.     entire risk as to the results and performance of this software is
  32.     assumed by the user.
  33.  
  34.    FUNCTION
  35.     RequestString is very similar to RequestChoice and RequestFile
  36.     which are included in the Workbench 3.x release.
  37.  
  38.     It allows the user to enter some text which is then printed to
  39.     StdOut. You can redirect that output to whereever you want,
  40.     e.g. to an environment variable or to any other file.
  41.  
  42.     It is 'pure' so it can be made resident.
  43.  
  44.    SYNOPSIS
  45.     RequestString TITLE/A,BODY/A,STRING/K,PUBSCREEN/K,NOLINE/S,
  46.                    NOQUOTE/S,NOEMPTY/S,PASSWORD/S,REQPOS/K
  47.  
  48.     TITLE (required)   titletext of requester
  49.  
  50.     BODY (req.)        text in the requester to explain to the user
  51.                        what to do... more textlines can be realized
  52.                        by using '*N' for a linebreak
  53.  
  54.     STRING (optional)  given text which can be changed by the user
  55.                        default: empty
  56.  
  57.     PUBSCREEN (opt.)   name od a public screen to open the requester on
  58.                        default: Workbench
  59.  
  60.     NOLINE (opt.)      no linebreak after text at output to StdOut
  61.                        default: linebreak
  62.  
  63.     NOQUOTE (opt.)     no quotes around text at output to StdOut
  64.                        default: text returned in "quotes"
  65.  
  66.     NOEMPTY (opt.)     if no string is entered RequestString returns with
  67.                        returncode WARN instead printing an empty string
  68.                        default: empty string is valid
  69.  
  70.     PASSWORD (opt.)    entered text is invisible, but output to StdOut
  71.                        is of course VISIBLE!
  72.                        default: visible
  73.  
  74.     REQPOS (opt.)      override the default-prefs of ReqTools
  75.                        REQPOS=CENTER centers the requester on screen
  76.                        REQPOS=POINTER opens the requester near to pointer
  77.                        default: ReqTools-Prefs
  78.  
  79.    EXAMPLE
  80.     RequestString "Titletext" "Please enter*Nsomething:" REQPOS=POINTER
  81.  
  82.    HISTORY
  83.     1.0 (12.08.94)   first public release
  84.                      (to Aminet in 12/96)
  85.  
  86.    DISTRIBUTION
  87.     Distribution on Aminet and AminetCDs is allowed.
  88.     Distribution by Fred Fish is allowed.
  89.     Distribution on MeetingPearlsCDs is allowed.
  90.  
  91.     You are allowed to include RequestString in your own projects as
  92.     long as they are Freeware. This RequestString.readme MUST also
  93.     be included!
  94.  
  95.     Other distribution without written permission of the author is
  96.     strictly forbidden (contact me via email).
  97.  
  98.  
  99. ============================= Archive contents =============================
  100.  
  101. Original  Packed Ratio    Date     Time    Name
  102. -------- ------- ----- --------- --------  -------------
  103.      628     265 57.8% 10-Dec-96 07:56:34  RequestString.info
  104.      584     479 17.9% 10-Dec-96 07:54:58 +RequestString
  105.     3165    1425 54.9% 10-Dec-96 07:54:42 +RequestString.readme
  106. -------- ------- ----- --------- --------
  107.     4377    2169 50.4% 18-Dec-96 12:57:50   3 files
  108.